Skip to content

[mcp-tools] Update GitHub MCP toolsets mapping and documentation to v2.0#17700

Closed
github-actions[bot] wants to merge 2 commits into
mainfrom
update-github-mcp-tools-mapping-2026-02-22-748c19bd19c00a85
Closed

[mcp-tools] Update GitHub MCP toolsets mapping and documentation to v2.0#17700
github-actions[bot] wants to merge 2 commits into
mainfrom
update-github-mcp-tools-mapping-2026-02-22-748c19bd19c00a85

Conversation

@github-actions

@github-actions github-actions Bot commented Feb 22, 2026

Copy link
Copy Markdown
Contributor

This PR updates documentation and tool mappings to align with the GitHub MCP server v2.0 toolset structure, as identified in the 2026-02-22 tools audit.

Changes

pkg/workflow/data/github_tool_to_toolset.json

Added 31 new tool mappings discovered in MCP server v2.0:

  • context toolset: get_copilot_space, github_support_docs_search, list_copilot_spaces (new Copilot-focused tools replacing get_teams/get_team_members)
  • repos toolset: get_repository_tree (new tool)
  • issues toolset: list_issue_types (new tool); moved search_issuessearch toolset
  • pull_requests toolset: moved search_pull_requestssearch toolset
  • actions toolset: actions_get, actions_list (renamed from get_workflow_run, list_workflow_runs)
  • dependabot toolset: get_dependabot_alert, list_dependabot_alerts (previously unmapped)
  • discussions toolset: get_discussion, get_discussion_comments, list_discussion_categories
  • gists toolset: get_gist
  • labels toolset: list_label (alongside existing list_labels)
  • notifications toolset: get_notification_details
  • orgs toolset: list_org_repository_security_advisories
  • projects toolset: all 6 project tools (get_project, get_project_field, get_project_item, list_project_fields, list_project_items, list_projects)
  • secret_protection toolset: get_secret_scanning_alert
  • security_advisories toolset: all 3 advisory tools
  • stargazers toolset: list_starred_repositories
  • search toolset: search_code, search_issues, search_orgs, search_pull_requests

skills/github-mcp-server/SKILL.md

Updated to reflect v2.0 tool names:

  • Replaced outdated context tools (get_teams, get_team_members) with new Copilot tools
  • Updated actions toolset to use new tool names (actions_list, actions_get)
  • Added all new toolsets with accurate tool listings
  • Added Legacy Tool Name Mapping table for migration from older allowed: configurations
  • Updated migration guide with current tool names

.github/instructions/github-mcp-server.instructions.md (new file)

Created comprehensive GitHub MCP server instructions file:

  • Complete tool reference organized by toolset (all 56 tools)
  • Configuration examples for common workflow patterns
  • Authentication details for remote and local modes
  • Token permissions reference table
  • Recommended default toolsets with rationale
  • Known limitations (billing data, GITHUB_TOKEN restrictions)

Audit Summary

Toolset Tools in v2.0 Notes
context 3 New Copilot-focused tools
repos 10 Added get_repository_tree
issues 4 Added list_issue_types
pull_requests 3 Reduced to read-only tools
actions 3 Renamed tools
code_security 2 Unchanged
dependabot 2 Previously undocumented
discussions 4 Expanded read tools
experiments 0 Empty
gists 2 Read-focused
labels 2 Renamed list_labelslist_label
notifications 2 Added get_notification_details
orgs 1 Focused on security advisories
projects 6 Previously undocumented
secret_protection 2 Unchanged
security_advisories 3 Previously undocumented
stargazers 1 Previously undocumented
users 0 Empty (requires PAT)
search 6 Expanded
Total 56

References: §22277200550

Generated by GitHub MCP Remote Server Tools Report Generator

  • expires on Feb 24, 2026, 12:45 PM UTC


✨ PR Review Safe Output Test - Run 22277347943

💥 [THE END] — Illustrated by Smoke Claude

- Add 31 new tool mappings to github_tool_to_toolset.json for tools
  introduced in MCP server v2.0 (copilot context tools, project tools,
  security advisory tools, dependabot tools, search toolset expansion,
  actions renamed tools, and more)
- Update SKILL.md with current tool names per v2.0 JSON mapping,
  including legacy tool name mapping table for migration guidance
- Create .github/instructions/github-mcp-server.instructions.md with
  comprehensive tool reference, configuration examples, authentication
  details, and recommended toolset rationale

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation labels Feb 22, 2026
@github-actions

Copy link
Copy Markdown
Contributor Author

✅ Pull request created: #17700

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor Author

✅ Commit pushed: 49bc879

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation smoke-claude

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants